home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / wincat25.zip / WINCAT.DOC < prev    next >
Text File  |  1993-01-01  |  40KB  |  1,168 lines

  1.           
  2.            WinCat - Windows Disk Catalog & FloppyDisk Manager
  3.            ==================================================
  4.  
  5.            Version 2.5, Januari 1993
  6.  
  7.            Created by Mart Heubel, Heerlen, The Netherlands
  8.  
  9.  
  10.  
  11. TABLE OF CONTENTS
  12. -----------------
  13.  
  14. * Introduction
  15. * Installing WinCat
  16. * Using WinCat
  17.    * Volume List Window
  18.      * Cataloging disks
  19.      * Cataloging archive contents
  20.      * Cataloging CD-ROM'S
  21.    * File List Window
  22.      * Restoring Files
  23.    * File Menu
  24.    * Options Menu
  25.    * Utilities Menu
  26.    * Help Menu
  27. * Hints and Tips
  28. * WinCat 2.5 Summary of Changes
  29. * WinCat 2.4 Summary of Changes
  30. * WinCat 2.3 Summary of Changes
  31. * WinCat 2.2 Summary of Changes
  32. * WinCat 2.1 Summary of Changes
  33. * WinCat 2.0 Summary of Changes
  34. * Things to Come
  35. * Registering WinCat
  36. * Your Comments Please
  37. * Distribution
  38. * Small Print
  39.  
  40.  
  41. INTRODUCTION
  42. ------------
  43.  
  44. WinCat is a tool that helps you organize your disks and enables you
  45. to quickly find and restore the files they hide.
  46.  
  47. Although there are various disk catalog programs around, none of
  48. them really suited my needs or taste.  Therefore I decided to write
  49. my own (always a guarantee for quality software !), and the result
  50. of a few weeks fooling around with Visual Basic and Turbo Pascal was
  51. WinCat 1.0.
  52.  
  53. Over the past months WinCat has evolved into what I humbly consider as
  54. the best floppy disk manager available for Windows today.
  55. However, a license to use this state-of-the-art tool only costs you
  56. an amazing 50 cents ; please read the 'Registering WinCat' section for
  57. details.
  58.  
  59.  
  60. Features of WinCat 2.5 :
  61.  
  62. - Easy to use
  63. - Ability to restore files or extract files from archives
  64.   WinCat interfaces to all DOS and Windows unarchive utilities
  65.   (like ARJ, LHA, PKUNZIP, WUNA, WINZIP etc.)
  66. - Kingsize comment fields on both file- and volume-entries
  67. - Supports sub-directories up to 3 levels deep
  68. - Supports multiple diskdrives (3.5", 5.25" and CD-ROM)
  69. - Extensive file search capabilities
  70. - ClipBoard interface for easy editing file-descriptions
  71. - Includes a conversion tool that extracts file-descriptions from
  72.   BBS Allfiles-listings or listings from other disk catalog programs
  73. - Automaticly copies file-descriptions from (4DOS) descript.ion files
  74.   to it's catalog
  75. - Reports : Volume Summary, Volume Contents, Files sorted by Filename
  76.   and Duplicate Files
  77. - Runs in Windows 3.x Real, Standard and 386-Enhanced mode
  78. - Allows you to create easy-to-work-with groups of volumes
  79. - Expensive looking '3D metallic' windows
  80. - Ability to catalog the contents of ARJ, ZIP, LZH, PAK and ARC archives.
  81.  
  82.  
  83.  
  84.  
  85. INSTALLING WINCAT
  86. -----------------
  87.  
  88. WinCat was written in Microsoft Visual Basic.  To run it, you must
  89. have Microsoft's run-time module file, VBRUN100.DLL, installed in
  90. your Windows directory.
  91. Because of it's size this file is not included in the WinCat package.
  92. However, if you don't have it there's no need to panic : you can download
  93. it from all WINNET nodes and most other BBS systems (look for file VBRUN*.*).
  94. You only need to download it once, since it works with all Visual Basic
  95. programs.
  96.  
  97. The WINCAT25 archive contains these files :
  98.  
  99.  *  - WINCAT.EXE         The WinCat program.
  100.  *  - WINCAT.INI         WinCat default settings & associations.
  101.  *  - WINCAT.CAT         A sample catalog.
  102.  *  - WINCAT.DOC         You're looking at it.
  103.  *  - WINCATDS.DLL       WinCat's DiskScan routines.
  104.     - WINCATCA.DLL       WinCat's Conversion Aid routines.
  105.  *  - WINCATPR.DLL       WinCat's Print routines.
  106.  #  - WINCATAR.DLL       WinCat's Archive Scan routines.
  107.     - WINCATRS.PIF       PIF that WinCat uses to launch WINCATRS.BAT.
  108.     - WINCATRS.BAT       BAT that WinCat uses to execute DOS unarchive
  109.                          utilities (like ARJ, LHA, PKUNZIP and COPY).
  110.  #  - 3DLABEL.VBX        Custom control needed by Visual Basic.
  111.  *  - READ.ME            For turbo-installers who never read DOC files.
  112.  
  113.  Compared with WinCat 2.4,  * = updated version
  114.                             # = new file
  115.  
  116. To install WinCat, create subdirectory C:\WINDOWS\WINCAT on your
  117. harddisk and extract WINCAT25.ARJ into that directory.
  118.  
  119. If you want to let WinCat catalog the contents of archive files you
  120. must also create subdirectory C:\WINDOWS\WINCAT\ARCHIVES\
  121. (See also 'Cataloging Archive Contents').
  122.  
  123. Move file WINCAT.INI to the \WINDOWS directory.
  124.  
  125. Edit WINCATRS.BAT and change the 'CD\SHEZ' statement to your directory
  126. that contains the DOS un-archivers you use, like ARJ.EXE, LHA.EXE and
  127. PKUNZIP.EXE .
  128. If these files are accessable through your default PATH, or if you
  129. prefer to include the path on the 'association' definitions, simply
  130. delete this statement.
  131.  
  132. You can let WinCat's 'restore file' function call WUNA (a shareware
  133. Windows UnArchive tool by James N. Hughes) to handle ZIP and ARJ files.
  134. WinCat doesn't specify a path when calling WUNA.EXE, so make sure this
  135. file is in your \WINDOWS directory.
  136. You can download WUNA from any WINNET BBS.
  137.  
  138. WINCAT.CAT is a sample catalog you can use to see what you can (or can't)
  139. do with WinCat.  If you decide to use WinCat to catalog your disks, erase
  140. the sample WINCAT.CAT.  Next time you start WinCat a new (empty) catalog
  141. will be created.
  142.  
  143. Now, all that's left to do is to add WINCAT.EXE to a Windows program group
  144. and start WinCat by clicking it's icon.
  145. (The PIF and BAT files are used only by WINCAT itself).
  146.  
  147.  
  148. USING WINCAT
  149. ------------
  150.  
  151. WinCat has two main windows : the 'Volume List' window, which displays
  152. all disks in the catalog, and the 'File List' window, which is used to
  153. display selected files.
  154.  
  155.  
  156. VOLUME LIST WINDOW
  157. ------------------
  158.  
  159. When you start WinCat you'll see the Volume List window : a scrollbox that
  160. shows the disks in the catalog, and a few buttons.
  161.  
  162. Explanation of the buttons :
  163.  
  164. [ VOL.INFO ]
  165.  
  166. Displays the 'Volume Information' window, which shows the :
  167.  
  168.         - volume ID
  169.         - group ID you defined
  170.         - date the disk was cataloged
  171.         - name of the associated archive contents (.ACT) file
  172.         - free and used diskspace in bytes
  173.         - a pie-chart that shows free and used diskspace
  174.         - number of files on the disk
  175.         - disk type (physical size and capacity)
  176.         - drive ID
  177.         - whether or not this volume is excluded from search operations
  178.         - any comment you entered.
  179.  
  180. The scrollbar at the left can be used to quickly scroll to other volumes.
  181.  
  182.  
  183. [ FILES ]
  184.  
  185. Shows all files that are cataloged on the selected volume.
  186. You can also do this by double-clicking a volume-entry.
  187. See explanation of the 'File List' window below.
  188.  
  189.  
  190. [ DIRECTORY ]
  191.  
  192. Displays the 'Directory List' window, which shows the directories
  193. on the selected disk. This window also shows the number of files
  194. and used diskspace per directory.
  195. Select a directory and click [FILES] to see all files in it.
  196. The same function can also be accomplished by double-clicking a
  197. directory entry.
  198. See also 'File List' window.
  199.  
  200.  
  201. [ UNCATALOG ]
  202.  
  203. This function will delete the selected volume (and all files cataloged
  204. on it) from the catalog.
  205. If there is a corresponding archive contents (.ACT) file this will be
  206. deleted as well.
  207. Of course you'll receive the inevitable prompt 'are you sure ?'.
  208.  
  209.  
  210. [ CHANGE ID ]
  211.  
  212. This function can be used to change the ID of a volume in the catalog.
  213. The new ID you enter must be unique ; if there is already a volume
  214. cataloged with the new ID, a messagebox appears prompting you to enter
  215. a different ID.
  216.  
  217.  
  218. [ SEARCH ]
  219.  
  220. Allows you to search for files in the catalog (click FILES) or for files
  221. in archives (click ARCHIVES).
  222. You can search for files in the catalog by specifying any combination of
  223. filename, extension, directory, comment, creation date and size.
  224. Files in archives can only be searched for by filename, extension, date
  225. and/or size.
  226.  
  227. WinCat will compare the strings you enter with the corresponding fields
  228. of all file-entries in the catalog.
  229. So, if you specify ICO for filename and EDIT for comment, WinCat will
  230. show all(*) files that have the string ICO somewhere in the filename AND
  231. that have the string EDIT somewhere in the comment field.
  232.  
  233. (*) Unless you've selected a volume-group, in which case WinCat will
  234.     search for files only on volumes belonging to that group.
  235.  
  236. Use the 'Show' box to select which fields you want initially displayed
  237. on the 'File List' window : the comment field or creation date, volume
  238. and directory fields.
  239.  
  240. Use the 'Sort' box to select how the file list entries should be sorted :
  241. filename/extension, extension/filename or volume/filename.
  242.  
  243. If you enable the 'search excluded disks too' checkbox, WinCat will search
  244. for files on all volumes in the catalog, including those that are normally
  245. excluded from search operations.
  246.  
  247. Clicking the [Clear] button clears all search-fields.
  248.  
  249. See also 'File List Window'.
  250.  
  251.  
  252. [ CATALOG ]
  253.  
  254. This function will scan a disk and add it's volume- and file-information
  255. to the catalog.
  256.  
  257. WinCat first displays the drive-select window.
  258. On this window you can specify whether or not you want a confirmation
  259. window displayed when you're recataloging a volume, and whether or not
  260. you want WinCat to catalog the contents of archive files on the disk.
  261. (you can pre-define these options on the Settings window).
  262.  
  263. Select the desired options, insert a disk in a drive and then select
  264. this drive by clicking the appropriate drive-button.
  265.  
  266. After scanning the directory of the disk WinCat displays the 'Catalog Disk'
  267. window, which shows the contents of the disk.
  268. On the 'Catalog Disk' window you must enter a volume-ID for the disk
  269. to be cataloged.  This ID may be 1 to 11 characters long.
  270. If the disk was labeled, the ID-field will show the label. You're free
  271. to change it : WinCat doesn't require that disklabel and (external)
  272. volume-ID are equal.
  273. The ID you enter will only be used to identify the volume in the catalog ;
  274. WinCat does NOT write the ID as a label on the disk.
  275.  
  276. When you click OK, WinCat will scan the catalog to see if the volume-ID
  277. you entered is already in use.
  278. If it isn't, the volume- and file-information will be added to the catalog.
  279.  
  280. If there IS a volume with the same ID in the catalog, WinCat compares the
  281. information in the catalog with the actual contents of the disk and
  282. shows the 'confirm recatalog' window which displays :
  283.   - files that are on the disk, but not yet cataloged
  284.   - files that are cataloged, but can't be found on the disk
  285.   - files on the disk that are newer than the ones cataloged
  286.   - files on the disk that are older than the ones cataloged
  287.  
  288. If you click the RECATALOG button, WinCat will delete the old volume
  289. (and it's files) from the catalog and add the new volume- and file-
  290. information to the catalog.  Volume- and file-comments will be copied
  291. from the old to the new volume- and file-records.
  292.  
  293. Remember that this window doesn't appear if you have turned the 'confirm
  294. recatalog' option (on the drive-select window) off. In this case WinCat
  295. automaticly recatalogs the volume.
  296.  
  297. 4DOS users
  298. ----------
  299. One of the nice features of 4DOS is that you can assign descriptions
  300. to your files. 4DOS saves these descriptions in a file called
  301. 'descript.ion'.
  302. When cataloging a disk, WinCat scans the root-directory of this disk for
  303. a 'descript.ion' file and, if found, copies the file-descriptions in this
  304. file to it's catalog.
  305. If there is an entry 'descript.ion' in the descript.ion file, WinCat
  306. will use it's description as a volume-description (get my point ?).
  307. If you don't want WinCat to use the descript.ion file, disable the
  308. appropriate option on the Settings window.
  309.  
  310. Cataloging Archive Contents
  311. ---------------------------
  312. You can optionally let WinCat catalog the contents of ARJ,ZIP,LZH,PAK and
  313. ARC archive files.
  314.  
  315. To do this, you must first create subdirectory \WINCAT\ARCHIVES\ and
  316. turn on the 'Catalog Archive Contents' option on either the Settings or
  317. Drive Select window.
  318. If you want to use another subdirectory you must specify it's full name
  319. on the Settings window (option 'Archive Directory'), e.g. 'D:\USERDATA\'
  320. or 'C:\WINDOWS\WINCAT\' 
  321.  
  322. When WinCat scans the archive files on a disk, it saves the information
  323. in the \ARCHIVES directory in a file named Fxxxxxxx.ACT, where xxxxxxx
  324. is some generated (timestamp) string.
  325. So, for every volume that WinCat scanned there is a .ACT file in this
  326. directory.
  327. On the 'Volume Information' window you can see which .ACT file (if any)
  328. belongs to a volume.
  329.  
  330. If you request WinCat to show the contents of a particular archive file,
  331. WinCat locates the .ACT file that's associated with the volume that
  332. contains the archive file and extracts the requested information from it.
  333.  
  334. Note that there is a one-to-one relationship between a volume and it's
  335. associated .ACT file ; therefore you shouldn't rename or delete .ACT
  336. files yourself, because then WinCat looses track and instead of the
  337. contents of an archive file will show you the message 'Can't find
  338. file Fxxxxxxx.ACT'.
  339.  
  340. If an error (CRC check, I/O error or whatever) occurs while scanning an
  341. archive file then WinCat aborts processing the current archive and
  342. proceeds with the next one.
  343.  
  344.  
  345. Cataloging CD-ROM disks
  346. -----------------------
  347. If you have a CD-ROM drive and the appropriate device-drivers installed
  348. on your system you can let WinCat catalog the contents of your CD-ROM
  349. disks.
  350. This isn't any different from cataloging floppy-disks ; WinCat will enable
  351. a drive-button on the 'Catalog Disk' window, and all you have to do is 
  352. to click this button.
  353. However, there is one restriction you should keep in mind : WinCat only
  354. catalogs a maximum of 1024 files per CD-ROM.
  355. The reason for this restriction is that the current (Visual Basic) version
  356. of WinCat isn't designed to handle huge amounts of files.  
  357. I don't think there are a lot of users who have more than 5000 files stored
  358. on their floppydisks ( well, maybe you're the only one...), but one CD-ROM 
  359. may well contain several thousands of files (I've seen one with 8000
  360. archive-files...). 
  361. Cataloging a few of these would result in a multi-megabyte database, and 
  362. searching for files in this database would take ages.
  363.  
  364.  
  365. [ EXIT ]
  366.  
  367. Ends WinCat. If catalog fragmentation has exceeded its treshold, a
  368. window will appear prompting you to reorganise the catalog.
  369.  
  370.  
  371. [ Icon Buttons ]
  372.  
  373. Click one of these to switch to the Windows ProgramManager, FileManager
  374. or TaskManager.
  375.  
  376.  
  377. FILE LIST WINDOW
  378. ----------------
  379.  
  380. This window is used to display all files on a volume, files in a
  381. particular directory or files that were found by the search function.
  382. The buttons INFO and RESTORE stay disabled until you select a file
  383. from the list.
  384.  
  385. What the buttons are for :
  386.  
  387. [ INFO ]
  388.  
  389. Displays the 'File Information' window, which shows :
  390.  
  391.         - filename
  392.         - ID of the disk the file is on
  393.         - file creation date and time
  394.         - file size in bytes
  395.         - directory the file is in
  396.         - an [archive info] button
  397.         - any comment you entered
  398.  
  399. The scrollbar at the left can be used to quickly scroll to other files.
  400. Click the [archive info] button to see the contents of an archive file.
  401.  
  402.  
  403. [ REST ]
  404.  
  405. This function can be used to restore files from floppy- to harddisk.
  406. The 'Restore File' window shows at the top the command that WinCat will
  407. execute if you click OK (you may edit this line).
  408.  
  409. The command that WinCat generates depends on the combination of
  410. (filename-)extension, the selected option in the 'action'-box,
  411. the selected target directory and the selected source drive.
  412.  
  413. The 'action'-box has 5 options :
  414.  
  415. - Copy file to harddisk       - Active for all files
  416. - Call WUNA                   - Only active for ARJ and ZIP files
  417.  
  418. The following options are active only if there is an association
  419. defined ( see Options menu : associate ) :
  420.  
  421. - Extract files from archive
  422. - View contents of archive
  423. - User defined function
  424.  
  425. If the generated command begins with 'DOS ' WinCat opens a DOS window
  426. to execute the (DOS) command through WINCATRS.BAT, else it will be
  427. launched as a Windows application.
  428.  
  429. [ ARC ]
  430.  
  431. Show the contents of an archive file.
  432. Of course the volume that contains this file must have been cataloged
  433. with the 'catalog archive contents' option turned on.
  434.  
  435. [ ALT.D ]
  436.  
  437. Clicking this button wil alternately display the files with their comment
  438. field only, or with volume, creationdate and directory fields.
  439.  
  440. [ COPY ]
  441.  
  442. Copies the filenames and their descriptions to the ClipBoard.
  443.  
  444. [ EDIT ]
  445.  
  446. Runs NotePad (or the editor you specified on the 'Editor=' statement in
  447. WINCAT.INI), where you can paste in and edit the data you put on the
  448. ClipBoard with [COPY].
  449. When you have completed editing, use the editor to copy the data back
  450. to the ClipBoard.
  451.  
  452. [ PASTE ]
  453.  
  454. Retrieves file-descriptions from the ClipBoard and stores them in
  455. the catalog.
  456. The ClipBoard records must have the format 'Filename.Ext Text'.
  457. The filename may be in upper- or lowercase.
  458.  
  459. [ PRINT ]
  460.  
  461. Copies the contents of the 'File List' window to WINCAT.LST, and then
  462. shows a message asking if you want to run the editor to edit or print
  463. this file (WINCAT.LST).
  464.  
  465. [ EXIT ]
  466.  
  467. Closes the 'File List' window.
  468.  
  469.  
  470. FILE MENU
  471. ---------
  472.  
  473. - Statistics
  474.   Displays volume- and file-count, total free and used space on your disks,
  475.   and some catalog information.
  476.  
  477. - Exit
  478.   Ends WinCat.
  479.   If catalog fragmentation has exceeded it's threshold, the 'Statistics'
  480.   window will be shown. You can then start catalog cleanup.
  481.  
  482.  
  483. OPTIONS MENU
  484. ------------
  485.  
  486. - Settings...
  487.   Displays a window where you can specify foreground and background colors,
  488.   catalog-related options and the editor you want WinCat to use.
  489.   Clicking the SAVE button will save these settings, plus the position
  490.   and size of the 'Volume List' and 'File List' windows in WINCAT.INI.
  491.  
  492. - Associate...
  493.   Associations are used by the Restore File function to determine
  494.   which command to generate.
  495.   Main purpose in WinCat is to associate archive files (like ARJ)
  496.   with their unarchive utilities, but if you like you can use them
  497.   for lots of other purposes.
  498.   Unlike the Windows File Manager, where you can associate only one
  499.   application with an extension, WinCat lets you define up to three
  500.   different associations, which can be used to :
  501.   - extract files from an archive
  502.   - view the contents of an archive
  503.   - some other function defined by you
  504.  
  505.   To define an association :
  506.  
  507.   - Enter the filename-extension (e.g. ARJ)
  508.     If there is already one or more association defined, this will
  509.     be displayed.
  510.     A special case is extension '*'. Files for which no specific
  511.     associations are defined will be associated with the commands you
  512.     define for this 'wildcard' extension.
  513.  
  514.   - Enter one or more commands, like :
  515.  
  516.     DOS ARJ E < >                (extract .ARJ files)
  517.     DOS C:\TOOLS\PKUNZIP.EXE < > (extract .ZIP files)
  518.     DOS PKUNZIP -v <             (view contents of .ZIP files)
  519.     NOTEPAD <                    (edit .DOC files)
  520.     C:\WINDOWS\WRITE.EXE <       (edit .WRI files)
  521.  
  522.     The Restore function will replace the '<' with the name of the
  523.     selected file, and '>' with the selected target directory.
  524.  
  525.     If a command begins with 'DOS ' it will be executed as DOS command
  526.     in a DOS window, else it will be executed as a true Windows
  527.     application.
  528.  
  529.   - Click the SAVE button.
  530.     This saves the association you defined in WINCAT.INI.
  531.  
  532.   The sample WINCAT.INI comes with this set of associations :
  533.  
  534. [WINCAT]
  535. Editor=notepad.exe
  536. Forecolor= 10
  537. Backcolor= 8
  538. EXTR_ARJ=DOS arj e < >
  539. VIEW_ARJ=DOS arj v <
  540. USER_ARJ=
  541. EXTR_ZIP=DOS pkunzip < >
  542. VIEW_ZIP=DOS pkunzip -v <
  543. USER_ZIP=c:\windows\programs\winzip.exe <
  544. EXTR_LZH=DOS lha e < >
  545. VIEW_LZH=DOS lha v <
  546. USER_LZH=c:\windows\programs\winzip.exe <
  547. EXTR_DOC=
  548. VIEW_DOC=
  549. USER_DOC=notepad <
  550. EXTR_LHA=DOS lha e < >
  551. VIEW_LHA=DOS lha v <
  552. USER_LHA=
  553. EXTR_TXT=
  554. VIEW_TXT=
  555. USER_TXT=notepad <
  556. EXTR_*=
  557. VIEW_*=
  558. USER_*=DOS copy < >*.*
  559.  
  560.  
  561. - Select Group...
  562.  
  563. With the 'Select Group' function you can limit the volumes displayed
  564. on the Volume List window to those belonging to the selected group.
  565. Also, when you select a group
  566.    - the Search function only looks for files on volumes belonging to
  567.      that group.
  568.    - a newly cataloged disk will be assigned to that group.
  569.    - the Statistics window shows the number of volumes and files and
  570.      the amount of free diskspace in that group.
  571.  
  572. You can select a group of volumes by making a selection from the list
  573. of already defined groups, or by searching for a string in each volume's
  574. description.
  575.  
  576.  
  577. UTILITIES MENU
  578. --------------
  579.  
  580. - Compare...
  581.   You can use this function to check whether files in a directory on
  582.   your harddisk, or files on one of your floppy disks, are cataloged.
  583.  
  584. - Import...
  585.   Use this function to import file-descriptions from BBS AllFiles
  586.   listings, listings from other (???!) disk catalog programs, 4DOS
  587.   descript.ion files etc.
  588.   This is the way to do it :
  589.  
  590.   1) Select the text file to import descriptions from.
  591.   This must be a 'normal' ASCII text file, that is each line must end
  592.   with a hex '0D0A' line delimiter.
  593.   The lines in this file must have the format 'Filename.Ext Text'.
  594.   WinCat ignores lines that don't adhere to this syntax.
  595.  
  596.   2) Specify whether you want WinCat to replace existing file-descriptions
  597.   with the imported ones by clicking the appropriate checkbox.
  598.  
  599.   3) Specify the number of words to drop between filename and description.
  600.  
  601.   A typical line in an AllFiles listing may look like this :
  602.  
  603.   WINCAT24.ARJ  88123  01-09-92  [23]  SPLENDID Disk Catalog for Windows
  604.  
  605.   Obviously, only the text 'SPLENDID Disk Catalog for Windows' should be
  606.   taken as the description for WINCAT24.ARJ.
  607.   To do this, you must tell WinCat how many words to drop from the text
  608.   following the filename WINCAT24.ARJ. In this example, the first 3 words
  609.   (strings delimited by one or more spaces) after WINCAT24.ARJ should be
  610.   dropped, so the number to specify is 3.
  611.  
  612.   When you click IMPORT, WinCat will scan the selected text file and copy
  613.   file-descriptions to the catalog. After a few seconds (depending on the
  614.   size of the text file and the catalog) WinCat displays the File List
  615.   window which shows all files with their updated descriptions.
  616.   If you're not completely happy with the result use [COPY], [EDIT]
  617.   and [PASTE] to change things.
  618.  
  619.   SIMULATE does the same as clicking OK, except that WinCat does NOT
  620.   update it's catalog.
  621.  
  622. - Reclaim
  623.   When you uncatalog or recatalog a volume, WinCat doesn't actually erase
  624.   the appropriate records from the catalog ; they are just marked as
  625.   deleted, and erased when you reorganise the catalog. Up till then, you
  626.   can use the 'reclaim' function to add the uncataloged volumes to the
  627.   catalog again. Their volume-id's will be translated to lowercase and
  628.   preceded by '-', so they will appear at the top of the Volume List
  629.   window.
  630.  
  631. - Print Volume Summary
  632.   Creates a listing of all volumes, and then shows a message asking if you
  633.   want to use the editor to edit or print this file (WINCAT.LST).
  634.  
  635. - Print Volume Contents
  636.   Creates a listing of all volumes and their contents.
  637.  
  638. - Print Files sorted by Filename
  639.   Creates a sorted listing of all files in the catalog.
  640.  
  641. - Print Duplicate Files
  642.   Creates a listing of files that occur more than once in the catalog.
  643.  
  644.  
  645. HELP MENU
  646. ---------
  647.  
  648. - Help
  649.   Shows WINCAT.DOC
  650.  
  651. - About WinCat
  652.   See for yourself...
  653.  
  654.  
  655. HINTS AND TIPS
  656. --------------
  657.  
  658. [1 - disk caching]
  659. WinCat's search and archive-scan functions result in quite a bit of I/O on
  660. your (hard)disks.  Use a disk caching utility like SmartDrive or (even
  661. better) HyperDisk, this will improve WinCat's (and any other application's) 
  662. performance considerably.
  663.  
  664. [2 - catalog reorganization]
  665. When you delete or recatalog volumes, WinCat doesn't actually erase the
  666. old records from the catalog : they are just marked as deleted.
  667. To prevent your catalog becoming bigger and bigger (with a lot of junk in
  668. it), WinCat checks the amount of fragmentation (junk) every time you end
  669. WinCat. If there are more than 100 deleted records in the catalog, WinCat
  670. will display the 'Reorganize Catalog'  window, showing some statistics
  671. and OK/Cancel buttons. If you click OK, WinCat will rename the catalog
  672. to WINCAT.BCK, create a new catalog WINCAT.CAT and copy the old catalog
  673. to the new catalog, leaving out all deleted records.
  674. Please note that, according to Murphy's Law, a backup is something you'll 
  675. never need unless you don't have it. So never erase file WINCAT.BCK... 
  676.  
  677.  
  678. 1-1-93  -  WINCAT 2.5 SUMMARY OF CHANGES
  679. ------------------------------------------
  680.  
  681. * General
  682.  
  683.   - All windows now have a glossy 3D metallic look.
  684.  
  685.   - CD-ROM support added.
  686.  
  687.   - This version of WinCat doesn't support version 1 catalogs anymore.
  688.     The previous WinCat versions automaticly converted version 1 catalogs
  689.     to the new version 2 format, so if you still have a version 1 catalog
  690.     use one of these to convert your catalog.
  691.  
  692. * Catalog Disk window
  693.  
  694.   - WinCat now has the ability to catalog the contents of ARJ,ZIP,LZH,PAK
  695.     and ARC archive files.
  696.  
  697.   - You can now specify whether or not you want WinCat to display the
  698.     'confirm recatalog' window.
  699.  
  700. * Volume List window
  701.  
  702.   - Now also shows to which group each volume belongs.
  703.  
  704.   - Volumes that are cataloged with the 'catalog archive contents' option
  705.     will be flagged with an 'A'.
  706.  
  707. * File List window
  708.  
  709.   - [Arc] button added. Click this button to show the contents of an archive
  710.     file.
  711.  
  712. * File Information window
  713.  
  714.   - [Archive Info] button added. Click this button to show the contents of
  715.     the current (archive-) file.
  716.  
  717. * Volume Information window
  718.  
  719.   - Now displays a pie-chart that shows used and free diskspace.
  720.     (this only works with volumes that are cataloged with WinCat 2.5).
  721.  
  722. * Select Group window
  723.  
  724.   - You can now also select volumes by searching for a string in their
  725.     comment fields.
  726.  
  727. * Search window
  728.  
  729.   - You can search for files in archives on your disks : specify any
  730.     combination of filename, extension, date and/or size (note that you
  731.     can't use the comment and directory fields) and click [Archives].
  732.  
  733. * Settings window
  734.  
  735.   - New options : 'catalog archive contents' and 'confirm recatalog'.
  736.       
  737. * Bugs fixed
  738.  
  739.   - The 'print all files sorted by filename' function went bananas when
  740.     there where 2000 or more files in the catalog. 
  741.  
  742.   - On 4DOS disks, WinCat didn't detect descript.ion files because of
  743.     there 'hidden' attribute.
  744.  
  745.  
  746. 22-09-92  -  WINCAT 2.4 SUMMARY OF CHANGES
  747. ------------------------------------------
  748.  
  749. * Catalog Disk Window
  750.  
  751.   - When cataloging a disk, WinCat will scan the root-directory of this
  752.     disk for a (4DOS) 'descript.ion' file and, if found, copy the file-
  753.     descriptions in this file to it's catalog.
  754.     If there is an entry 'descript.ion' in the descript.ion file, WinCat
  755.     will use it's description as a volume-description.
  756.  
  757. * Volume List Window
  758.  
  759.   - 3 icon-buttons added. Click one of these to switch to the Windows
  760.     ProgramManager, FileManager or TaskManager.
  761.  
  762. * File List Window
  763.  
  764.   - The PASTE function now also accepts filenames in lowercase.
  765.  
  766. * Restore File Window
  767.  
  768.   - You can now specify which drive to use when restoring a file.
  769.     As a default, WinCat uses the drive the file was cataloged on.
  770.  
  771. * Volume Information Window
  772.  
  773.   - Allows you to assign a (1- to 8-character) group-id to any volume.
  774.     You can select an already defined group from the drop-down list, or
  775.     enter a new group-id.
  776.     See also 'Select Group'.
  777.  
  778.   - The 'UPDATE' key has gone : when you change either the comment, group
  779.     or exclude field, WinCat automaticly updates the catalog-record.
  780.  
  781. * File Information Window
  782.  
  783.   - The 'UPDATE' key has gone : when you change the comment-field, WinCat
  784.     automaticly updates the catalog-record.
  785.  
  786. * File Menu
  787.  
  788.   - The Statistics window also displays the number of defined groups.
  789.  
  790.   - The 'Save settings' function has been replaced by a SAVE button on
  791.     the Settings window.
  792.  
  793. * Options Menu
  794.  
  795.   - On the 'Settings' window you'll find 2 new 4DOS related options.
  796.     On this window you can also specify which editor you want WinCat
  797.     to use. As a default, WinCat uses NotePad.
  798.  
  799.   - With the 'Select Group' function you can limit the volumes displayed
  800.     on the Volume List window to those belonging to the selected group.
  801.     Also, when you select a group
  802.     - the Search function only looks for files on volumes belonging to
  803.       that group.
  804.     - a newly cataloged disk will be assigned to that group.
  805.     - the Statistics window shows the number of volumes and files and
  806.       the amount of free diskspace in that group.
  807.  
  808.   - The COMPARE function has been moved to the Utilities menu.
  809.  
  810. * Utilities Menu
  811.  
  812.   - The new IMPORT function allows you to import file-descriptions from
  813.     BBS AllFiles listings, listings from other disk catalog programs,
  814.     4DOS descript.ion files etc.
  815.  
  816.   - Prior to reorganising the catalog, you can use the RECLAIM function
  817.     to add (accidently) un- or re-cataloged volumes to the catalog again.
  818.  
  819.   - With the PRINT function you can now also print a short volume summary
  820.     listing, a listing of all files sorted by filename, or a listing of
  821.     files that occur more than once in the catalog.
  822.  
  823. * Bugs fixed
  824.  
  825.   - The scrollbar on the Volume Directory List window overlayed
  826.     the filecount per directory.
  827.  
  828.   - On the 'Catalog Disk' window it was possible to enter a volume-id
  829.     that was more than 11 characters long. WinCat now truncates the id
  830.     you enter to max. 11 characters.
  831.  
  832.   - The 'Catalog Disk' function showed an empty window when there was
  833.     no disk or an empty disk in the selected drive. WinCat now detects
  834.     this situation and prompts you to correct it.
  835.  
  836.   - WinCat reported 5.25" 1.2MB disks to be of an <unknown> type.
  837.  
  838.   - When restoring a file, WinCat didn't take into account on which
  839.     drive the file was cataloged, and always tried to restore from
  840.     drive A. Since it's quite difficult to insert a 5.25" disk in
  841.     a 3.5" drive, this has been changed.
  842.  
  843.   - Upon display of the 'Restore File' window, it could happen that
  844.     this window picked up a different file to be restored than the
  845.     one you selected.
  846.  
  847.   - The sequence numbers that appeared on catalog listings are gone
  848.     now.
  849.  
  850.   - When ending WinCat with the Controlbox option 'Close', WinCat
  851.     remained an active, but non-existent task on the TaskManagers list.
  852.  
  853.  
  854. 05-07-92  -  WINCAT 2.3 SUMMARY OF CHANGES
  855. ------------------------------------------
  856.  
  857. * WINCATDS.EXE has been replaced by WINCATDS.DLL.
  858.   WinCat now runs in Windows Standard, Real and 386-Enhanced mode.
  859.  
  860. * File List Window
  861.  
  862.   - ClipBoard interface added.
  863.     (see [COPY], [EDIT] and [PASTE])
  864.  
  865.   - Buttons have been moved to the right of the window to allow
  866.     resizing.
  867.  
  868. * Restore File Window
  869.  
  870.   - You can now select any drive as target for files to be restored.
  871.  
  872. * Bugs fixed
  873.  
  874.   - WINCATDS returned a corrupted disk-label if that was exactly 8
  875.     characters long (doesn't this guy TEST anything...?).
  876.  
  877.   - WinCat couldn't see the difference between a 5.25" 1.2MB disk and
  878.     a 3.5" 720KB disk because DOS returned a hex 'F9' media descriptor
  879.     for both disk-types. WINCATDS now checks the number of sectors in a
  880.     cluster to tell the two apart.
  881.  
  882.  
  883.  
  884. 20-05-92  -  WINCAT 2.2 SUMMARY OF CHANGES
  885. ------------------------------------------
  886.  
  887. * Menu
  888.  
  889.   - 'Associate' selection added to 'Options'-menu.
  890.  
  891.   - 'Save settings' selection added to 'File'-menu.
  892.  
  893. * Colors menu
  894.  
  895.   - 'Save' button removed. Use 'Save settings' to save the current
  896.     color settings.
  897.  
  898. * Print Menu
  899.  
  900.   - The listing of all volumes now also shows each volume's comment
  901.     field.
  902.  
  903. * Volume List and File List windows
  904.  
  905.   - Can now be resized and moved. Use 'Save settings' to save their
  906.     current position and size.
  907.  
  908.   - The Volume List window marks volumes that are excluded from search
  909.     operations with an 'X'.
  910.  
  911. * Volume Information window
  912.  
  913.   - 'Exclude from search' checkbox added.
  914.  
  915. * Search Files window
  916.  
  917.   - Now allows you to search for files that exceed a certain size,
  918.     and/or that are created before, on, or after the date you specify.
  919.  
  920.   - 'Search excluded volumes too' checkbox added.
  921.  
  922. * Restore File window
  923.  
  924.   - 'User defined function' added to 'action' box.
  925.  
  926.   - The restore function now uses user-defined associations when generating
  927.     commands.
  928.  
  929. * Catalog Disk window
  930.  
  931.   - The drop-down list with available drives has gone : now each drive
  932.     is represented by a button.
  933.  
  934.   - When recatalogging a disk, a window is displayed which shows the
  935.     differences between the old catalog-information and the actual disk.
  936.  
  937. * Bugs fixed
  938.  
  939.   - Instead of just dying, WinCat now issues a message when the 'Restore
  940.     File' window tries to run a non-existent windows application.
  941.  
  942.   - WinCat showed a corrupted disklabel if that was 9 or more characters
  943.     long (between the 8th and 9th character a dot was inserted).
  944.     WINCATDS.EXE has been changed to fix this.
  945.  
  946.   - Still problems with the combination WINCAT/WINCATDS.
  947.     The change I made in WinCat 2.1 (WinCat waiting on WINCATDS)
  948.     could cause problems when running Windows in Real or Standard mode.
  949.     Fix : WinCat now issues a 'retry / cancel' message if WINCATDS
  950.     doesn't respond after a reasonable amount of time.
  951.  
  952.     I must admit that it's a bit clumsy that WinCat calls a DOS EXE
  953.     to scan the disk to be cataloged, but then, Visual Basic doesn't
  954.     provide the necessary functions to get all the information, so
  955.     you're forced to use external routines.
  956.     Putting these in a DLL library would solve all problems, and would
  957.     enable WinCat to work in Real or Standard mode too.
  958.     However, as far as I know you need the Windows System Development Kit
  959.     to create a DLL, and believe me SDK doesn't come cheap.
  960.     So, unless one of you folks lends a helping hand, we'll have to
  961.     keep on mudding...
  962.  
  963.  
  964. 10-05-92  -  WINCAT 2.1 SUMMARY OF CHANGES
  965. ------------------------------------------
  966.  
  967. * Menu
  968.  
  969.   - 'Options' menu added.
  970.     Fore- and background colors can now be changed using the 'Colors'
  971.     selection.
  972.  
  973.   - 'File' menu.
  974.     'Statistics' selection added.
  975.  
  976. * Directory List window
  977.  
  978.   - Now also shows the root directory (as [root]), and used diskspace and
  979.     number of files in each directory.
  980.  
  981. * Volume List window
  982.  
  983.   - Double-clicking an entry shows the File List window.
  984.  
  985. * File List window
  986.  
  987.   - Double-clicking an entry shows the Restore File window.
  988.  
  989. * Restore window
  990.  
  991.   - Retains the selected target directory.
  992.  
  993. * General
  994.  
  995.   - Code has been changed to make WinCat a bit faster.
  996.  
  997. * Bugs fixed
  998.  
  999.   - WINCAT didn't catalog 'hidden' files (well, I guess that's why they
  1000.     are called that way...).
  1001.     WINCATDS.EXE has been changed to fix the problem.
  1002.  
  1003.   - On slower (IBM ?) systems you could have the problem that WINCAT didn't
  1004.     wait long enough on WINCATDS to finish. WINCAT has been tought to be a
  1005.     bit more patient and to wait until his little slave has finished his job
  1006.     or until hell freezes over, which ever comes first.
  1007.  
  1008.  
  1009. 21-03-92  -  WINCAT 2.0 SUMMARY OF CHANGES
  1010. ------------------------------------------
  1011.  
  1012. * Search Criteria window
  1013.  
  1014.   - Directory search-field added.
  1015.  
  1016.   - 'Show' options added.
  1017.     With these options you can select which fields initially should be
  1018.     displayed on the 'File List' window.
  1019.  
  1020.   - 'Sort' options added.
  1021.     With these options you can select how to sort entries on the
  1022.     'File List' window.
  1023.  
  1024.   - [CE] button added.
  1025.     Clicking this button wil clear all search fields.
  1026.  
  1027. * Volume List window
  1028.  
  1029.   - [PRINT] button removed.
  1030.     Use the PRINT menu option to print a listing of all files.
  1031.  
  1032.   - [DIRECTORY] button added.
  1033.     This function shows all (sub-)directories on the selected volume.
  1034.  
  1035. * File List window
  1036.  
  1037.   - [Alt.Display] button added.
  1038.     Clicking this button will alternately display comment field, or
  1039.     volume, creationdate and directory fields.
  1040.  
  1041. * Restore File window
  1042.  
  1043.   - 'Call WUNA' option added to 'action' box.
  1044.     This option is only active for ARJ and ZIP files.
  1045.  
  1046.   - 'Target Directory' list now reacts on single clicks.
  1047.  
  1048. * General
  1049.  
  1050.   - WINCATDS.EXE now supports drives A-Z.
  1051.  
  1052.   - The structure of WinCat's catalog has slightly changed.
  1053.     If you start WinCat 2.0 with a version 1.0 catalog then WinCat
  1054.     automaticly converts the old catalog to the new 2.0 format.
  1055.     (The old catalog will be saved as WINCAT.BCK).
  1056.  
  1057.   - Some minor cosmetic changes.
  1058.  
  1059. * Bugs fixed
  1060.  
  1061.   - Edit-fields don't lose focus (cursor) anymore.
  1062.  
  1063.  
  1064. THINGS TO COME
  1065. --------------
  1066.  
  1067.                       WinCat/PRO 3.0
  1068.                       --------------
  1069.  
  1070. A turbo version of WinCat, written entirely in Turbo Pascal for Windows !
  1071.  
  1072. Planned General Availability : May '93.
  1073.  
  1074. On the drawing board :
  1075.  
  1076.         - enhanced CD-ROM support 
  1077.         - catalog compression
  1078.         - intelligent disk shuffler
  1079.  
  1080.  
  1081. REGISTERING WINCAT
  1082. ------------------
  1083.  
  1084. WinCat is a PostWare product ; this means that if you use it you don't
  1085. have to pay any license-fee, but instead of this you do have the moral
  1086. obligation to register by sending me a nice postcard with a picture of
  1087. the town you live in, a beautifull blonde nudy or anything else you
  1088. fancy.
  1089. Of course a good bottle of (scotch) whisky will be accepted with the
  1090. utmost gratitude too, hips...
  1091.  
  1092. So, instead of feeling guilty for the rest of your life, send your
  1093. postcard to :
  1094.  
  1095.         Mart Heubel
  1096.         De Heugden 161
  1097.         6411 DR  Heerlen
  1098.         The Netherlands
  1099.  
  1100.  
  1101. YOUR COMMENTS PLEASE
  1102. --------------------
  1103.  
  1104. If you discover serious bugs in WinCat, or if you have any "wouldn't it
  1105. be nice if WinCat ..." ideas, feel free to send me a note at one of these
  1106. bulletin boards :
  1107.  
  1108. - CyberDyne Systems              FIDO 2:512/1002 (R28 WINNET host)
  1109. - InterAction (formerly WildCat) FIDO 2:500/222  (WINNET node)
  1110.  
  1111.  
  1112. DISTRIBUTION
  1113. ------------
  1114.  
  1115. WinCat may be freely copied and distributed, as long as the following
  1116. conditions are met :
  1117.  
  1118.   [1] No fee is charged other than a normal time usage fee required
  1119.       by some Bulletin Board Services.
  1120.   [2] The program and it's associated files are distributed in their
  1121.       original, unmodified form.
  1122.   [3] This document file is included with the executable file without
  1123.       modification.
  1124.  
  1125. This program may not be bundled with, or transferred as part of, any
  1126. package which is sold or for which any licensing fee is charged without
  1127. the prior written permission of the author.
  1128.  
  1129. Copies of this program or any of it's associated files remain property
  1130. of the author.
  1131.  
  1132.  
  1133. ACKNOWLEDGEMENTS
  1134. ----------------
  1135.  
  1136. The 3DLABEL.VBX file (a Visual Basic custom control used to create
  1137. WinCat's 3D look) was created and donated to public domain by :
  1138.  
  1139.   Jiang, Jeng Long
  1140.   Mountain View, CA
  1141.  
  1142. Code for determining the contents of ZIP, PAK and ARC archives is based
  1143. on sourcecode from the program PIBCAT, which was created by :
  1144.  
  1145.   Phil Burns
  1146.  
  1147. Code for determining the contents of ARJ archives is based on sourcecode
  1148. from the program ARJDATE, which was created by :
  1149.  
  1150.   Darren Lyon
  1151.  
  1152. Code for determining the contents of LZH archives is based on sourcecode
  1153. from the program LZHTV10, which was created by :
  1154.  
  1155.   Samuel H. Smith
  1156.   Phoenix, AZ
  1157.  
  1158.  
  1159. SMALL PRINT
  1160. -----------
  1161. Registering this program entitles you only to a) let WinCat occupy
  1162. your diskspace and b) use WinCat.
  1163. No guarantee is made, expressed or implied, pertaining to the use,
  1164. misuse, or any problems caused by this program.
  1165. In no event will the author be liable for any damages whatsoever
  1166. arising out of the use or the inability to use this product.
  1167. 
  1168.